home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Tools / Docs / DeliTrak < prev    next >
Text File  |  1995-09-13  |  63KB  |  1,324 lines

  1.  
  2.  
  3.                  $VER: DeliTracker.eng V2.18 (19.08.1995)
  4.                    Copyright 1995 by Delirium Softdesign
  5.                       (Peter Kunath and Frank Riffel)
  6.  
  7.  
  8.  
  9.                 1.OVERVIEW
  10.  
  11.                 2.LICENSING AND DISTRIBUTION
  12.  
  13.                 3.ORDERFORM
  14.  
  15.                 4.GETTING STARTED
  16.                   4.1 System requirements
  17.                   4.2 First steps
  18.                   4.3 Tooltype Settings and Shell Environment
  19.  
  20.                 5.BASICS
  21.                   5.1 Players
  22.                   5.2 Genies
  23.                   5.3 Packed modules
  24.                   5.4 Module lists
  25.  
  26.                 6.HOW TO CONTROL DELITRACKER
  27.                   6.1 The main window
  28.                   6.2 The option window
  29.                   6.3 The player window
  30.                   6.4 The genie window
  31.                   6.5 The program window
  32.                   6.6 Shortcuts
  33.                   6.7 Commodities
  34.                   6.8 Arexx
  35.  
  36.                 7.NOTES
  37.  
  38.                 8.ACKNOWLEDGEMENTS
  39.  
  40.  
  41. 1.OVERVIEW
  42.  
  43.   Welcome to DeliTracker 2.18. For those who don't know: DeliTracker is a
  44.   highly flexible soundplayer which supports many sound formats. The replay
  45.   routines for the common formats ProTracker, NoiseTracker, SoundTracker 15
  46.   and 31 instrument version and StarTrekker without AM sounds, are builtin.
  47.   Additional players can be loaded from disk. DeliTracker is NOT a Sampler,
  48.   Digitizer, MIDI sequencer nor a song editor. It is only meant to play
  49.   music modules in a very comfortable way. Here are some good reasons for
  50.   using DeliTracker:
  51.  
  52.         ° System friendly and multitasks happily
  53.         ° Highly expandable due to modular concept
  54.         ° Allocates the sound channels
  55.         ° Supports xpkmaster.library for decrunching
  56.         ° Correct play speed in PAL/NTSC (uses timerdevice)
  57.         ° Works well with serial.device
  58.         ° Modulelists
  59.         ° ARexx
  60.         ° PubScreen support
  61.         ° Hotkey (Commoditiy)
  62.         ° Appwindow, modules can be played by simply dropping the module
  63.           icon (or even a hole directory) into the mainwindow
  64.         ° Written in 100% Assembler
  65.  
  66.  
  67. 2.LICENSING AND DISTRIBUTION
  68.  
  69.        DeliTracker (c) 1991 - 1995 by Peter Kunath and Frank Riffel.
  70.  
  71.   DeliTracker 2.18, the DeliTracker tool icon, their related documentation,
  72.   utilities, and examples (hereinafter "Files") and in particular player
  73.   and genie interface are (c) Copyright 1991-95 by Peter Kunath and Frank
  74.   Riffel. All Rights Reserved.
  75.  
  76.   You may send bug reports, remarks, and suggestions to this address:
  77.  
  78.                                Frank Riffel
  79.                                 Merkstr. 27
  80.                              82405 Wessobrunn
  81.                                  Germany
  82.  
  83.   If you have written a new soundsystem and you wish to adapt your replay-
  84.   routine to DeliTracker, contact us. We will help you.
  85.  
  86.   This is a registered Version of DeliTracker. It may only be used by the
  87.   owner of an Aminet CD #8. This license does not cover any further updates.
  88.   No part of this release may be re-distributed.
  89.  
  90.   DeliTracker has been developed and tested thoroughly. Never-the-less, the
  91.   Authors cannot be held responsible for any damages that are caused by
  92.   DeliTracker. The Files and their related documentation, utilities, and
  93.   examples are provided "AS-IS" and subject to change without notice; no
  94.   warranties of any kind, either expressed or implied, including, but not
  95.   limited to, the implied warranties of merchantability and fitness for a
  96.   particular purpose. No liability or responsibility is assumed. Use at
  97.   your own risk.
  98.  
  99.   Installer and Installer project icon (c) Copyright 1991-93
  100.   Commodore-Amiga, Inc. All Rights Reserved. Reproduced and
  101.   distributed under license from Commodore.
  102.  
  103. 3.ORDERFORM
  104.  
  105. ***************************************************************************
  106. *                                                                         *
  107. *       For registration, send this form to:                              *
  108. *          Frank Riffel, Merkstr. 27, 82405 Wessobrunn, Germany           *
  109. *                                                                         *
  110. ***************************************************************************
  111. *                                                                         *
  112. *                   ***********************************                   *
  113. *                   **                               **                   *
  114. *                   ** DeliTracker Registration Form **                   *
  115. *                   **                               **                   *
  116. *                   ***********************************                   *
  117. *                                                                         *
  118. *                                                                         *
  119. *  Name : ______________________________________________________________  *
  120. *                                                                         *
  121. *  Address : ___________________________________________________________  *
  122. *                                                                         *
  123. *  City : _____________________________ State: _________________________  *
  124. *                                                                         *
  125. *  Postal Code: _______________________ Country: _______________________  *
  126. *                                                                         *
  127. *  email : _____________________________________________________________  *
  128. *                                                                         *
  129. *  DeliTracker Version: ______  Kickstart: _______  Amiga : ____________  *
  130. *                                                                         *
  131. *                                                                         *
  132. ***************************************************************************
  133. *                                                                         *
  134. *                                                                         *
  135. *                                OPTIONAL                                 *
  136. *                                                                         *
  137. *  RAM : _____ MB FAST-RAM    Processor : 680__0                          *
  138. *                                                                         *
  139. *        _____ MB CHIP-RAM                                                *
  140. *                                                                         *
  141. *  Email : _____________________________________________________________  *
  142. *                                                                         *
  143. *  Comments : __________________________________________________________  *
  144. *                                                                         *
  145. *  _____________________________________________________________________  *
  146. *                                                                         *
  147. *  _____________________________________________________________________  *
  148. *                                                                         *
  149. *  _____________________________________________________________________  *
  150. *                                                                         *
  151. *  _____________________________________________________________________  *
  152. *                                                                         *
  153. *  _____________________________________________________________________  *
  154. *                                                                         *
  155. *  _____________________________________________________________________  *
  156. *                                                                         *
  157. *  _____________________________________________________________________  *
  158. *                                                                         *
  159. *                                                                         *
  160. ***************************************************************************
  161.  
  162.  
  163. 4.GETTING STARTED
  164.  
  165.   4.1 System requirements
  166.  
  167.   DeliTracker II requires at least Workbench and Kickstart 2.0 (aka V37).
  168.   We recomend the usage of Workbench 2.1 (or 3.x), because the ASL
  169.   Filerequester of V38 and above is much faster and supports multiselect.
  170.   If you want to use packed modules, the 'xpkmaster.library' and the
  171.   corresponding sublibraries must be installed. Make sure that you use V2
  172.   of XPK! V1 is NOT sufficient. DeliTracker requires at least 150KB of
  173.   memory. Additional memory is needed for every loaded genie, player, the
  174.   current modulelist and the decrunched module. Of course, your System
  175.   should be equiped with a Monitor that has speakers, or even better,
  176.   connected to a HiFi system.
  177.  
  178.   4.2 First Steps
  179.  
  180.   If you already use an older version of DeliTracker, please delete all the
  181.   files in the old distribution and your configuration files. Now run the
  182.   supplied installer script by simply double clicking on the apropriate
  183.   installation icon. The installation script will install DeliTracker on
  184.   your harddisk into a drawer named DeliTracker. After the installation
  185.   we strongly suggest that you move seldom used players and genies to the
  186.   storage dirs (e.g. from DeliPlayers/ to DeliPlayers/PlayerStore/). If you
  187.   don't do this you will waste memory! If you need a particular player or
  188.   genie you can still load it by yourself. If you start DeliTracker the
  189.   first time besides the control window a few other windows will be opened.
  190.   On 68000er systems this can take some seconds. These windows belong to
  191.   particular players or genies. To avoid that DeliTracker opens all these
  192.   windows every time you start you must configure them. It is not hard to
  193.   do this. Activate a window. Now select the desired options. You will find
  194.   several options in the 'Settings' menu. If you whish that the window
  195.   should not be opened every time you start DeliTracker turn 'Popup' off.
  196.   Some windows additionaly contain gadgets for several options. For those
  197.   functions and options refer to 'Genies.doc' or 'Players.doc'. Now save
  198.   these settings using the 'Save Prefs' from the 'Project' menu. You may
  199.   close the window now and continue with another.
  200.  
  201.   Note: There is an ENV: variable called DELICONFIG. It contains the path
  202.   to the configuration directory. This variable is important if DeliTracker
  203.   was installed on a CD-ROM. You can set this variable to a directory on
  204.   your harddisk (e.g SYS:DeliConfig). This enables you to use your favorite
  205.   settings rather than the predefind on the CD.
  206.  
  207.   4.3 Tooltype Settings and Shell Environment
  208.  
  209.   For Shell usage you must separate all keywords and arguments by spaces.
  210.   Strings which contain spaces must be quoted. For Workbench usage (i.e.
  211.   tooltypes) seperate the arguments from the keywords with '='. To set the
  212.   tooltypes use the 'Information' item of the Workbench. Invalid Tooltypes
  213.   are ignored. DeliTracker can be used as a 'Default Tool'. For this you
  214.   have to enter the path where DeliTracker is located at the 'Default Tool'
  215.   line of the module. This asumes that the module has a project icon.
  216.  
  217.   Shell Example: 'DeliTracker config "DELI Config" volume 32 filter no'
  218.  
  219.   Starts DeliTracker with 'DELI Config' as configuration file, turns the
  220.   lowpass filter off (not on A1000's) and sets the volume to 32.
  221.  
  222.   These options are used as KEYWORDS in Tooltypes and as CLI templates.
  223.   The keywords are not case sensitive!
  224.  
  225.   Option                  Default value and description
  226.   --------------------    -----------------------------
  227.  
  228.   config <file>           "DeliConfig/DeliTracker.config"
  229.                           Loads the specified file as a configuration file.
  230.  
  231.   cx_priority <pri>       0 (default priority)
  232.                           Sets the commodities priority. Valid values
  233.                           are -128 to 127.
  234.  
  235.   cx_popup <yes|no>       yes (window opened)
  236.                           Defines if the control window should be opened
  237.                           at startup. If it is set to 'no', no window will
  238.                           be opened. The mainwindow may be opened later via
  239.                           hotkey, Commodities Exchange or with an ARexx
  240.                           command.
  241.  
  242.   cx_popkey <string>      "" (no hotkey), see also Hot Key
  243.  
  244.   closequits <yes|no>     no  =  CloseWindow will hide the GUI
  245.                           This option describes the behaviour when you push
  246.                           the close gadget of the mainwindow. If turned on
  247.                           DeliTracker will quit if the window is closed.
  248.                           This is also known as the 'Nessy' option:-)
  249.  
  250.   module <file>           No file, empty module list.
  251.                           Uses <file> as startup module. Note: You can use
  252.                           Modulelists as well.
  253.  
  254.   playerpath <path>       "DeliPlayers"
  255.                           Sets the searchpath for external players.
  256.  
  257.   geniepath <path>       "DeliGenies"
  258.                           Sets the searchpath for external genies.
  259.  
  260.   pubscreen <Screen>      "", default PubScreen (usually Workbench).
  261.                           Let you specify the name of the public screen
  262.                           where DeliTracker, all Player and Genie windows
  263.                           should pop up. If the given screen is not
  264.                           available (e.g. does not exist), DeliTracker
  265.                           opens its windows on the default public screen.
  266.                           Note: Screen names are case sensitive in V37!
  267.  
  268.   mainwinxy<XPos>/<YPos>  0/1
  269.                           Attempts to open the mainwindow at the given
  270.                           position.
  271.  
  272.   prefwinxy<XPos>/<YPos>  0/1
  273.                           Attempts to open the option window at the given
  274.                           position.
  275.  
  276.   playwinxy<XPos>/<YPos>  0/1
  277.                           Attempts to open the player window at the given
  278.                           position.
  279.  
  280.   geniewinxy<XPos>/<YPos> 0/1
  281.                           Attempts to open the genie window at the given
  282.                           position.
  283.  
  284.   progwinxy<XPos>/<YPos>  0/1
  285.                           Attempts to open the program window at the given
  286.                           position.
  287.  
  288.   filereq <X/Y/W/H>       "" (requester internal default setting)
  289.                           Specifies the filerequester coordinates.
  290.  
  291.   volume <volume>         64 (maximal volume)
  292.                           Sets the volume to <volume>. Where volume can
  293.                           range from 0 to 64.
  294.  
  295.   balance <balance>       0
  296.                           Sets the balance to <balance>. Where balance can
  297.                           range from -64 (left channels only) to 64 (right
  298.                           channels only).
  299.  
  300.   quickstart <yes|no>     yes (module is played immediately after loading)
  301.                           Defines if a loaded module should begin to play
  302.                           immediately after loading or if the module is
  303.                           in a paused state. This option is meant for
  304.                           synchronization purposes in ARexx scripts.
  305.  
  306.   filter <yes|no>         no (filter off)
  307.                           Switches the internal lowpass filter on or off.
  308.                           An advantage of having the filter off is that
  309.                           frequencies over 7kHz are not cut off. This has
  310.                           the effect that most modules will sound much
  311.                           better.
  312.                           Note: On A1000 this switch has no effect.
  313.  
  314.   appicon <yes|no>        yes (display appicon)
  315.                           If turned on an appicon is left when mainwindow
  316.                           is closed else no appicon appears.
  317.  
  318.   lowchip <yes|no>        no (use chipmem for modules)
  319.                           If turned on DeliTracker tries to use fastmem
  320.                           for the module.
  321.  
  322.   swapplay <yes|no>       no (don't use low memory handler)
  323.                           If turned on DeliTracker will attempt to flush
  324.                           unused players. DeliTracker will re-load the
  325.                           players when needed. This function works only
  326.                           with V39 and above.
  327.  
  328.   songend <yes|no>        no (ignore songend signals)
  329.                           Lets you specify whether songend events should
  330.                           be ignored or not. Some players support a
  331.                           notification of the song end. If this option is
  332.                           set, DeliTracker will pause the module and load
  333.                           the next module. If only one module is in the
  334.                           soundlist then it is paused after the song has
  335.                           played once.
  336.  
  337.   append <yes|no>         no (replace modulelist with new selection)
  338.                           Lets you specify whether the soundlist should be
  339.                           inserted at the current position or replaced by
  340.                           the new selection.
  341.  
  342.   randmod <yes|no>        no (play modules in sequential order)
  343.                           Lets you specify whether a Next/Prev-Song event
  344.                           should take a randomly picked or the following
  345.                           (preceeding) list entry for loading. Once a
  346.                           module has been played it won't be reselected
  347.                           until other selected modules have been played.
  348.                           This behaviour is also known as 'Shuffleplay'.
  349.                           This option only works if there are more than 2
  350.                           entries in the modulelist.
  351.  
  352.   activate <yes|no>       yes (activate window at startup)
  353.                           If turned off all windows are opened in inactive
  354.                           state. May be useful for shell users. Hi Zop :-)
  355.  
  356.   timeout <secs>          0 (no timeout)
  357.                           Lets you specify the amount of time (in secs)
  358.                           after that DeliTracker will cause a Next-Song
  359.                           event. A value of 0 disables timeout. If songend
  360.                           is enabled DeliTracker will react on the first
  361.                           event that occours.
  362.  
  363.   fadeout <secs>          0 (don't fade)
  364.                           Lets you specify the time for fadeing out. A
  365.                           value of zero disables the smooth transition
  366.                           between two modules. This feature is only
  367.                           available for players that support volume
  368.                           changing.
  369.  
  370.   randsong <yes|no>       no (first subsong)
  371.                           Lets you specify whether the first or a random
  372.                           subsong should be choosen when a new module is
  373.                           played.
  374.  
  375.   playstart <yes|no>      yes (startmodule is played at startup)
  376.                           Defines weather the startup-module should be
  377.                           played when DeliTracker is started.
  378.  
  379.  
  380. 5.BASICS
  381.  
  382.   5.1 Players
  383.  
  384.   The player concept is one of the strong points in DeliTracker. After
  385.   loading a player DeliTracker will recognize and play modules of this
  386.   type. It has the advantage that you may only load the players that you
  387.   need (= efficient memoryusage). Of course you may unload any player at
  388.   any time. Another advantage is that you only need to know how to use
  389.   DeliTracker rather than every single player. Multimedia applications in
  390.   conjunction with ARexx greatly benefit from this (e.g. You may play any
  391.   Module in an AmigaVision(TM) presentation). Another major advantage is
  392.   that the player interface is very flexible so everyone may easily enhance
  393.   update or adapt players. For details on programming read the includefile
  394.   and 'Developer.doc'. DeliTracker has the common players built in. These
  395.   are: SoundTracker15, SoundTracker31, StarTrekker without AM sounds,
  396.   NoiseTracker and ProTracker. There is another player called 'CustomPlay'.
  397.   This is a special player that was created to play special modules that
  398.   contain their own replay code. These 'modules' may not be crunched,
  399.   because they are loaded via LoadSeg() to allow relocation. In V2 we have
  400.   added support for player processes (i.e. Now it should be fairly easy to
  401.   create players that load samples directly from disk). Another improvement
  402.   is the introduction of the "Noteplayer Interface". This is nothing else
  403.   than virtualizing all sound hardware accesses. The player does not write
  404.   to the hardware at all instead it fills out a structure with the needed
  405.   information. DeliTracker passes this structure to a Noteplayer Genie that
  406.   handles the sound processing. Other genies may evaluate this data, too.
  407.   The number of external players that may be loaded is only limited by the
  408.   amount of free memory. When DeliTracker is started all players in the
  409.   'DeliPlayers' directory or the specified playerpath e.g. tooltypes or in
  410.   the configfile are loaded. The external players are listed and described
  411.   in the 'Players.doc'.
  412.  
  413.   5.2 Genies
  414.  
  415.   Genies are a new concept in Release 2.0. Basicaly they are little
  416.   "programs" which extend or enhance DeliTrackers functionality. In many
  417.   respects genies are similiar to commodities. They can react on user
  418.   actions and DeliTracker's internal program states. They can have their
  419.   own GUI that can be shown or hidden. Genies usualy run as seperate
  420.   processes. This enables them to do asynchronus event processing. You
  421.   can quit a genie either with the remove genie function (found in the
  422.   genie window) or by sending a CTRL-C to the genie process itself. The
  423.   GUI of a genie usualy offers menus with the following menu items:
  424.  
  425.         Project
  426.                 About      A ?  Short info about the genie.
  427.                 ==============
  428.                 Save Prefs A S  Save the current settings as default
  429.                 ==============
  430.                 Hide       A H  Hide the GUI
  431.                 ==============
  432.                 Quit       A Q  Remove the Genie
  433.  
  434.         Settings
  435.                 Activate   A A  Activates the window if the GUI is opened
  436.                 Popup      A P  Opens the GUI when the Genie was loaded
  437.                 ==============
  438.                 Other settings  Other genie specific settings, see the
  439.                 ··············  particular genie documentation.
  440.  
  441.   There are different types of genies:
  442.  
  443.   NotePlayer Genies
  444.     This type of genie has the task of hiding the actualy used audio
  445.     hardware. You can think of a NotePlayer genie like a virtual audio
  446.     device. A major reason for virtualizing the hardware accesses, is
  447.     that later NotePlayers could make use of high quality sound cards
  448.     (or a new chipset) which may support more than four channels. With
  449.     the help of the CPU (or later a DSP)a Noteplayer genie can emulate
  450.     more than four channels. As a side effect of the currently used mixing
  451.     technology for the native amiga soundhardware, we can reduce the
  452.     chipmem usage to 1KB of sample buffer memory. For future compatibility,
  453.     the NotePlayer mechanism is prepared to handle 16 Bit samples, as well
  454.     as for several sample encoding schemes (signed/unsigned/ulaw). Players
  455.     that support this interface will greatly benefit from this. Here are
  456.     some of the advantages:
  457.  
  458.                 ° Independence of the used audio hardware
  459.                 ° Independence of the number of hardware channels
  460.                 ° Audiodata can be shared with other genies as well
  461.                   (Stereoscope, Quadrascope, FFT Analyzer ....)
  462.                 ° Resource handling is done by the Noteplayer genie
  463.                   This includes memory/channel allocation and hardware
  464.                   initialisation.
  465.                 ° Volume and Balance control is also done by the genie
  466.  
  467.     When a player requires a Noteplayer, DeliTracker will try to use the
  468.     "cheapest" noteplayer it can get. The choice is based on following
  469.     criterias: CPU usage, used memory type and the number of channels.
  470.     They are evaluated in that order.
  471.  
  472.   Decrunch Genies
  473.     Decrunch genies can decrunch files that are loaded by DeliTracker.
  474.     Note: You will run into trouble if you want to load multipart modules
  475.     from one archive. Think of a LhA'ed TFMX module!
  476.  
  477.   Convert Genies
  478.     Convert one module format into another. The user has the advantage that
  479.     only few optimized and bugfree players are needed to play a variety of
  480.     "packed"/"optimized"/"crypted" module formats. In most cases you would
  481.     need much more code for a player than for a converter.
  482.  
  483.   Other Genies
  484.     These Genies have no defined task. They can control or monitor many
  485.     things. Many users have suggested that we should supply "graphical
  486.     equalizers" and other things that make the screen alive. Or just
  487.     wanted more information about the current module. With this type of
  488.     genie it is possible to extend DeliTracker, so that more infos can be
  489.     displayed. And indeed in most cases they display optional information.
  490.     This can be simple things like sample names, number of patterns, or
  491.     the filesize. With the aid of a fast CPU they can also display more
  492.     complex things like the current waveforms or the frequency distribution
  493.     (think of an FFT Analyzer). Genies that display such complex things
  494.     will usually run at process priority of -5 so they will only get the
  495.     cpu when no other important task needs the cpu.
  496.  
  497.   Only the Paula-NotePlayer Genie is internal. This is a Noteplayer for up
  498.   to 4 voices that uses the audio.device channel allocation and direct
  499.   writing to the hardware for output. The user can select the allocation
  500.   precedence. All other genies are loaded at startup from '/DeliGenies'.
  501.   For the external genies refer to 'Genies.doc'.
  502.  
  503.   5.3 Packed modules
  504.  
  505.   If xpkmaster.library V2 or higher is installed DeliTracker will use the
  506.   library for decrunching. Optionaly you may load Decrunch Genies for use
  507.   of other packers. Certain players do not support module packing! This is
  508.   due to the fact that those players load the module by themselves rather
  509.   than using the internal LoadFile() function. If the player-info field
  510.   for a particular player shows 'Packable....NO' you are not allowed to
  511.   crunch modules for this player.
  512.  
  513.   NOTE: Don't pack custom modules because they are loaded and RELOCATED via
  514.   LoadSeg()! The only way to get around this is to use the XFH filehandler
  515.   or patch LoadSeg() with xLoadSeg to be able to load XPK compressed files.
  516.  
  517.   5.4 Modulelists
  518.  
  519.   DeliTracker has an internal Modulelist, that can be manipulated with the
  520.   program window. Add modules, arrange each entry as you want and save the
  521.   whole as a modulelist. Later you can retrive your favorite selection.
  522.  
  523.   Modulelists are organized as ascii files. The first line must contain
  524.   'MODLIST' as an identifier. Each further line can contain the filename
  525.   of a module, a module directory or the path of another modulelist.
  526.  
  527.   DeliTracker treads Modulelists nearly like modules. The difference is
  528.   that when DeliTracker wants to 'play' a Modulelist, the modulelist it is
  529.   treated as a new selection of modules. The 'Random Mod' and the 'Append'
  530.   flags are evaluated. WARNING: In one very special case this leads to a
  531.   deadlock situation. This happens when the first entry in the Modulelist
  532.   is the list itself and 'Random Mod' is off. At that point DeliTracker
  533.   will not stop to replace the modulelist by itself again and again.
  534.   Don't create such lists!
  535.  
  536.  
  537. 6.HOW TO CONTROL DELITRACKER
  538.  
  539.   6.1 The main window
  540.  
  541.   The main window is the central part of the DeliTracker. All module
  542.   specific things may be controlled with this panel. DeliTracker's
  543.   main window consists of four groups. Each group can be folded away,
  544.   so that you can choose which parts of the window are visible. If the
  545.   window is active the titlebar shows the actual list nubmer, the number
  546.   of modules in the list, the used player and the filename of the module.
  547.   The following is a overview of how the full window looks. Note: If a
  548.   gadget is drawn ghosted, then this option is not accessible for this
  549.   player. There could be two reasons for this:First, the soundsystem
  550.   does not have this feature at all (e.g. SoundTracker has no SubSongs),
  551.   and second, the player is not perfectly adapted (which is more likely).
  552.  
  553.   +----------+--------------------------------------+------------+
  554.   | Module:  | ////////////MODULE NAME///////////// |  [ Time ]  |\
  555.   +----------+--------------------------------------|------------| Info
  556.   | Format:  | ///////////MODULE FORMAT//////////// |  00:00:00  |/
  557.   +----------+--------------------------------------+------------+\
  558.   | Comment: | [ ====================== 13 =================== ] | Comment
  559.   +---+---+--++-+------------------------------------------+-+---+/
  560.   |   |   |   | |                                     [12] | |   |\
  561.   |[O]|[P]|[G]+-+------------------------------------------+-+[R]| Control
  562.   |   |   |   | |                      [11]                | |   |/
  563.   +---+---+-+-+-++-----+-----+-----+----+-----+-----+-----++-+---+
  564.   |[+]|     |    |     |     |     |    |     |     |     | +--\ |\
  565.   +---+  |< |  < |  << |  |> |  >> |  > |  >| |  [] |  ^  | |  | | Tapedeck
  566.   |[-]|     |    |     |     |     |    |     |     |  -  | +--+ |/
  567.   +---+-----+----+-----+-----+-----+----+-----+-----+-----+------+
  568.         [1]   [2]  [3]   [4]   [5]   [6]  [7]   [8]   [9]   [10]
  569.  
  570.     Tapedeck group
  571.  
  572.      [+] Faster: plays song a little faster
  573.  
  574.      [-] Slower: plays song a little slower
  575.  
  576.      [1] Prev Song: play the previous song. This gadget is only enabled if
  577.          more than one file was selected. If 'Random Mod' is selected this
  578.          button picks a random module. See also 'Random Mod'.
  579.  
  580.      [2] Prev SubSong: Jumps to the previous sub-song (if available).
  581.  
  582.      [3] Prev Pattern: Jumps to the previous pattern. If the current
  583.          pattern is the first, the counter is set to the last pattern.
  584.  
  585.      [4] Play/Pause: Plays a paused sound or pauses a playing sound.
  586.  
  587.      [5] Forward: Jumps to the next pattern in the module. If the current
  588.          pattern is the last, the counter wraps around to the first.
  589.  
  590.      [6] Next SubSong: Plays the next subsong of a module. This function
  591.          allows you to select other melodies in the module. Not every
  592.          soundsystem provides you this feature. One of the most common
  593.          soundsystems that provide multi-modules are TFMX and MED.
  594.  
  595.      [7] Next Song: This button loads the next module form the selected
  596.          modulelist. If the last module of the list is playing and you
  597.          press this button the first module of the list will be played
  598.          (cyclic list). If 'Random Mod' is selected this button has the
  599.          same function as the Prev Song button.
  600.  
  601.      [8] Stop Song: This button resets the patterncounter and the speed to
  602.          the initial default value.
  603.  
  604.      [9] Eject Module: stops the actual module and removes it from memory.
  605.  
  606.     [10] Load Song: Opens the filerequester and lets you select one or
  607.          more modules for playing. If you select an empty directory
  608.          DeliTracker will scan the whole dir and add all files matching
  609.          the module pattern (see option window). The first selected
  610.          module is loaded and played. If enough memory is available,
  611.          DeliTracker will use double buffering. This means that the
  612.          current song continues playing until the next song is loaded.
  613.  
  614.     Control group
  615.  
  616.      [O] opens or closes the Optionwindow
  617.  
  618.      [P] opens or closes the Playerwindow
  619.  
  620.      [G] opens or closes the Genieswindow
  621.  
  622.      [R] opens or closes the module Programwindow
  623.  
  624.     [11] Balance Control: Let you change the Balance.
  625.  
  626.     [12] Volume Control: Let you change the Volume.
  627.  
  628.     Comment group
  629.  
  630.     [13] Comment: Here you can read/enter an optional comment. If you hit
  631.          'Return' the comment is saved.
  632.  
  633.     Info group
  634.  
  635.          This group contains some informations about the current module.
  636.          Namely the module name, the format name and the the time how long
  637.          the module has been played. Note: If the player supports internal
  638.          modulenames, the real modulename is displayed rather than just the
  639.          filename. There may be a difference between the format name and the
  640.          playername: If a module has been converted with a converter genie
  641.          the format name is the source format (e.g. NoisePacker 2.0) and not
  642.          the destination format (ProTracker).
  643.  
  644.     [Time] Resets the time counter to 00:00:00.
  645.  
  646.     Menus
  647.  
  648.     The non menu shortcuts are only shown if running under V39 or above.
  649.  
  650.         Project
  651.                 Open        <A> O   ...Open the filerequester.
  652.                 =================
  653.                 Play/Pause      0   ...Play or pause a module.
  654.                 Stop Playing    1   ...Stop the actual module.
  655.                 =================
  656.                 Next Module     ]   ...Load the next module in the
  657.                                        Soundlist. See also 'Random Mod'.
  658.                 Prev Module     [   ...Load previous module.
  659.                 Eject Module    .   ...Stop playing and remove the
  660.                                        actual module from memory.
  661.                 =================
  662.                 About...    <A> ?   ...Open about requester.
  663.                 =================
  664.                 Hide        <A> H   ...Close all windows.
  665.                 =================
  666.                 Quit        <A> Q   ...Leave the program.
  667.  
  668.            Control
  669.                 Faster            + ...Increase playspeed.
  670.                 Slower            - ...Decrease playspeed.
  671.                 Reset Speed       * ...Reset playspeed.
  672.                 ===================
  673.                 Forward           5 ...Jump one Pattern forward.
  674.                 Backward          4 ...Jump one Pattern backward.
  675.                 ===================
  676.                 Next Subsong      8 ...Play next Subsong.
  677.                 Prev Subsong      7 ...Play previous Subsong.
  678.                 ===================
  679.                 Volume Up         6 ...Increase Volume.
  680.                 Volume Down       9 ...Decrease Volume.
  681.                 Reset Volume      / ...Reset Volume to max.
  682.                 ===================
  683.                 Left Balance      2 ...More left balance.
  684.                 Right Balance     3 ...More right balance.
  685.                 Reset Balance Enter ...Reset Balance to balanced.
  686.  
  687.         Settings
  688.                 Info          <A> I ...Turn info group on/off.
  689.                 Comment       <A> C ...Turn comment on/off.
  690.                 Control       <A> N ...Turn control group on/off.
  691.                 Tapedeck      <A> T ...Turn tapedeck group on/off.
  692.                 ===================
  693.                 Options...    <A> S ...Open option window.
  694.                 Players...    <A> P ...Open player window.
  695.                 Program...    <A> R ...Open module list window.
  696.                 Genies...     <A> G ...Open genies window.
  697.                 ===================
  698.                 Load Settings...    ...Load saved settings.
  699.                 Save Settings       ...Save default settings.
  700.                 Save Settings As... ...Save settings to selected file.
  701.  
  702.     Appwindow
  703.  
  704.     To make the module selection even more comfortable, icons from modules
  705.     and module drawers may be dropped on the control window. The modules
  706.     will be handled as if they were selected with the file requester. If
  707.     a drawer is dropped, all files will be scanned. All files that match
  708.     the module pattern will be added to the module list. Sub-directorys are
  709.     not scanned. To use this feature the control window of DeliTracker must
  710.     be opened on the workbench screen.
  711.  
  712.   6.2 The option window
  713.  
  714.   The option window is for seting all global options. To open the option
  715.   window you may either select the 'Options...' menu or the '?'-Gadget of
  716.   the mainwindow.
  717.  
  718.     Startup Mod default ""
  719.                 This module is loaded when DeliTracker is started. If it
  720.                 is a module list DeliTracker will automaticaly load the
  721.                 first module which is specified in the module list. You
  722.                 can either enter the module by typing the path into the
  723.                 stringgadget, or using the file requester gadget behind.
  724.  
  725.     Player Dir  default "DeliPlayers"
  726.                 this is the path where DeliTracker searches for players.
  727.  
  728.     Genie Dir   default "DeliGenies"
  729.                 this is the path where DeliTracker searches for genies.
  730.  
  731.     Pubscreen   default is "", (default PubScreen, usually Workbench)
  732.                 Let you specify the name of the public screen where
  733.                 DeliTracker should pop up. If the given screen is not
  734.                 available (e.g. does not exist), DeliTracker opens it's
  735.                 windows on the default public screen.
  736.                 Note: Under V37 screen names are case sensitive!
  737.  
  738.     Hot Key     default is "" (no hotkey)
  739.                 This defines the hotkey which is used to open or close the
  740.                 windows. If the DeliTracker windows are closed via the
  741.                 hotkey, all other Player and Genie windows are closed as
  742.                 well - the same applies to Hide Interface. To disable the
  743.                 hotkey, use the INACTIVE option of the Commodities Exchange
  744.                 Program.
  745.  
  746.     Pattern     default "~(#?.info|info.#?|smpl.#?|#?.NT(%|.(pp|im|xpk)))"
  747.                 Defines the pattern of the module requester. This pattern
  748.                 is also used when scanning directorys. It enables the user
  749.                 to hide unused (nonmodule files, like #?.info) files.
  750.  
  751.     Songend     default is OFF (ignore songend signals)
  752.                 Lets you specify whether songend events should be honored
  753.                 or not. Some players support a notification of the songend.
  754.                 If this option is set, DeliTracker will pause the module
  755.                 and load the next module in the list. If only one module
  756.                 is in the soundlist, then it is paused after the song has
  757.                 played once.
  758.  
  759.     Timeout     default is 0 (no timeout)
  760.                 Lets you specify the amount of time in secs, after which,
  761.                 DeliTracker will cause a Next-Song event. A value of 0
  762.                 disables module timeout.
  763.  
  764.     Quickstart  default is ON (module is played immediately after loading)
  765.                 Defines if a loaded module should begin to play immediately
  766.                 after loading or if the module is in a paused state. You
  767.                 can use this option for synchronization purposes in ARexx
  768.                 scripts.
  769.  
  770.     Fadeout     default is 0 (don't fade)
  771.                 Lets you specify how many seconds the fadeout of a song will
  772.                 take. Fadeing is performed after every eject event. If you
  773.                 select zero no smooth transition will be done. This feature
  774.                 is only available for players that support volume changing.
  775.  
  776.     Random Mod  default is OFF (sequential order)
  777.                 Lets you specify whether a Next/Prev-Song event should
  778.                 choose a random pick, or the following (preceeding) list
  779.                 entry for loading. Once a module has been played it won't
  780.                 be reselected until other selected modules have been
  781.                 played. This behaviour is also known as 'Shuffleplay'.
  782.                 This option only works if there are more than 2 entries
  783.                 in the modlist.
  784.  
  785.     Random Song default is OFF (first subsong)
  786.                 Lets you specify whether the first or random subsong should
  787.                 be choosen when a new module with subsongs is played.
  788.  
  789.     Filter      default is OFF (filter off)
  790.                 Switches the internal lowpass filter 'on' or 'off'. If the
  791.                 switch is 'off' it has the advantage that frequencies over
  792.                 7kHz are not cut off. This has the effect that most modules
  793.                 will sound much better. Note: The A1000 filter cannot be
  794.                 switched off!
  795.  
  796.     Append      default is OFF (replace modulelist with new selection)
  797.                 Lets you specify whether the soundlist should be inserted
  798.                 at the current position or replaced by the current file
  799.                 selection.
  800.  
  801.     Appicon     default is OFF
  802.                 If the Appicon feature is selected and the mainwindow is
  803.                 closed, an appicon will be created. All files that are
  804.                 dropped into the appicon will be handled as if they were
  805.                 selected with the file requester. If a drawer is dropped,
  806.                 all files will be scanned and added to the module list.
  807.                 Only files which are not matching the pattern will be
  808.                 skipped. Subdirectorys are not scanned. A double click
  809.                 on the appicon will open the windows again.
  810.  
  811.     Activate    default is ON (activate windows)
  812.                 If turned off, all windows are opened in inactive state at
  813.                 startup. May be useful for shell users.
  814.  
  815.     Play at Start default is ON (startmodule is played at startup)
  816.                 Defines whether the startup-module should be played when
  817.                 DeliTracker is started.
  818.  
  819.     Prefix      default is 4
  820.                 Specifies the maximum size of the prefix in chars. If a
  821.                 prefix is encountered DeliTracker won't show it the module
  822.                 list. DeliTracker recognizes a prefix by the first dot in
  823.                 the filename. Example: Prefix is set to 3, the filename
  824.                 'dw.sentinel' will be stripped down to 'sentinel' whereas
  825.                 'mdat.TurricanI' won't be changed. This setting influences
  826.                 the module list sorting.
  827.  
  828.     Swap Players default is OFF
  829.                 If turned on DeliTracker will attempt to flush
  830.                 unused players on low memory situations. DeliTracker will
  831.                 re-load the players when needed. This function works only
  832.                 with V39 and above.
  833.  
  834.     Low Chipmem default is OFF
  835.                 If turned on DeliTracker tries to use a Noteplayer that
  836.                 can play from fastmemory else the default Noteplayer
  837.                 choosing algorithm is used. This does not mean that every
  838.                 module is now loaded into fastmemory. Only modules of
  839.                 those players which support the noteplayer interface will
  840.                 be located in fast memory.
  841.  
  842.     Load        Load a saved configuration and set all values to those of
  843.                 a previously saved configuration.
  844.  
  845.     Save        Save all actual settings to a configuration file. The
  846.                 configuration file contains all above settings plus the
  847.                 filerequester and window co-ordinates. The default config
  848.                 file is saved to the configuration directory. It is named
  849.                 "DeliTracker.prefs". If you select another path/filename
  850.                 the prefs file is saved to this path.
  851.  
  852.     OK          Close the options window.
  853.  
  854.   6.3 The player window
  855.  
  856.     The player window contains all controls for the deliplayers. On the
  857.     right side is a listview which shows all players that are currently
  858.     loaded. When the player window is opened the currently active player
  859.     is selected. Under V39 the active player is always highlighted. A 'D'
  860.     in front of the playername marks all players that are disabled. A
  861.     disabled player stays in memory, but DeliTracker doesen't call it's
  862.     checkcode. A double click on an entry will toggle the player on/off.
  863.     If you select one entry, all information about this player is shown
  864.     on the left hand. Old players will have a version number less then
  865.     1.00 (ie. 0.03).
  866.  
  867.         Config          Configure selected player
  868.         Show            Open the player's GUI
  869.         Hide            Close the player's GUI
  870.         Add             Load (an)other player(s)
  871.         Remove          Unload selected player
  872.         Clear           Unload all external players
  873.         Ok              Close player window
  874.  
  875.     If a player with the same name is already loaded, the player with the
  876.     lower version number will be expunged. Internal players may be removed
  877.     too, but their memory is of course not freed. To add a whole directory
  878.     of players, just select the dir and make sure that the filename-string
  879.     in the file requester is empty. Now DeliTracker scans the directory and
  880.     loads every player. For selecting the default player path see
  881.     Options-Window.
  882.  
  883.   6.4 The genie window
  884.  
  885.     The genies window contains all controls for deligenies. It is very
  886.     similar to the player window. When this window is opended the currently
  887.     used NotePlayer is selected. With V39, the active NotePlayer Genie will
  888.     be highlighted.
  889.     As in the player window, a double click on an entry will enable/disable
  890.     it. Another double click on a NotePlayer Genie will force this NotePlayer.
  891.     This means DeliTracker will use this genie for playing whenever possible.
  892.     A 'F' in front of the geniename marks this NotePlayer as forced. Only one
  893.     NotePlayer can be forced at a time.
  894.  
  895.         Config          Configure selected player
  896.         Show            Open genie GUI
  897.         Hide            Close genie GUI
  898.         Add             Load (an)other genies(s)
  899.         Remove          Unload selected genie
  900.         Clear           Unload all external genies
  901.         Ok              Close genie window
  902.  
  903.     If a genie with the same name is already loaded, the genie with the
  904.     lower version number will be expunged. Internal genies may be removed
  905.     as well, but of course the memory is not freed. Adding a whole dir of
  906.     genies works the same as above. Just select the dir and DeliTracker
  907.     will load all genies. For selecting the default genie path, see
  908.     Options-Window.
  909.  
  910.   6.5 The program window
  911.  
  912.     The listview shows all modules that are in the current modulelist. If
  913.     the filename of the module has a prefix (max. four chars + '.') then
  914.     DeliTracker won't show the prefix. Under V39 the current module is
  915.     highlighted. Depending on the selected mode, a click on an listview
  916.     entry will have a different effect.
  917.  
  918.         Play            Plays the selected Module.
  919.         Move            The selected module is removed from the list and
  920.                         moved into an internal buffer. When another entry
  921.                         is selected the cut entry is inserted below that
  922.                         entry. Just try it. It is very easy to move the
  923.                         modules around.
  924.         Delete          Removes the selected entry form the modulelist.
  925.         New             Removes the complete Modulelist.
  926.         Insert          Open Requester for inserting modules.
  927.         Current         Jumps to current module, it is centered.
  928.         Load            Load a saved Modulelist.
  929.         Save            Saves the current Modulelist starting with the
  930.                         active module. All entrys are saved!
  931.         Sort            Sorts the Modulelist.
  932.         Ok              Closes the program window.
  933.  
  934.     Note: Modulelist's are treaded like modules, the difference is that
  935.     when "played" they replace/extend the current modulelist and try to
  936.     load the first module of the modulelist (if 'Random Mod' is off). This
  937.     is potentialy dangerous, when the first entry in a modulelist is the
  938.     modulelist itself. So don't create such lists!
  939.  
  940.   6.6 Shortcuts
  941.  
  942.   Nearly all funtions of DeliTracker can be reached via keyboard short
  943.   cuts. Any underlined chars in a gadget text indicates the shortcut for
  944.   that gadget. The shortcuts are ony active for the particular window the
  945.   gadget belongs to. All shortcuts will only work if the corresponding
  946.   action is possible. Although the shortcuts can be entered in upper or
  947.   lower case. All stringadgets can be left with the 'esc' key. For ease of
  948.   use every DeliTracker window additionaly has the following shortcuts:
  949.  
  950.   F1  open/activate main window
  951.   F2  open/activate option open window
  952.   F3  open/activate player window
  953.   F4  open/activate genie window
  954.   F5  open/activate program window
  955.  
  956.   Because the main window makes heavy use of buttons with images
  957.   rather than text buttons, we couldn't use the underscoreing method
  958.   for indicating the shortcut. Some of the main window shortcuts are
  959.   menu shortcuts (RAmiga+Menukey) while the others are simple keys.
  960.   To make them easy to remember we decided to order them in hirarchy
  961.   on the nummeric keypad. Of course the shortcuts can be used even if
  962.   the corresponding function group is folded away.
  963.  
  964.     Simple key shortcuts, see also main window menu section.
  965.  
  966.     +----------+----------+----------+----------+
  967.     |PrevMod   ·NextMod   |ResetVol  |ResetSpeed|
  968.     |[         ·]         |/         |*         |
  969.     +----------+----------+··········+··········+
  970.     |PrevSub   ·NextSub   |VolDown   |Slower    |
  971.     |7         ·8         |9         |-         |
  972.     +----------+----------+··········+··········+
  973.     |PrevPat   ·NextPat   |VolUp     |Faster    |
  974.     |4         ·5         |6         |+         |
  975.     +----------+----------+----------+----------+
  976.     |Stop      |LBal      ·RBal      ·ResetBal  |
  977.     |1         |2         ·3         ·Enter     |
  978.     +----------+----------+----------+          |
  979.     |Play/Pause           |Eject     |          |
  980.     |0                    |.         |          |
  981.     +----------+----------+----------+----------+
  982.  
  983.   In additon you may specify a global hot key for the opening and closing
  984.   of the mainwindow. This hotkey works even if no DeliTracker window is
  985.   not active. See also cx_popkey and hot key option below.
  986.  
  987.   6.7 Commodities
  988.  
  989.   DeliTracker is a Commodity, therefore some typical things may be
  990.   controlled from within the Commodities Exchange Program. First select
  991.   'DeliTracker' in the 'Available Commodities' box. The cycle gadget shows
  992.   you if the hotkey for opening/closing the mainwindow is enabled or not.
  993.   Click once to change this. 'Show Interface' will open and activate the
  994.   mainwindow. 'Hide Interface' will close all DeliTracker windows. Finally
  995.   a click on the 'Remove' button will quit DeliTracker. As usual for
  996.   commodities, a CLICK ON THE CLOSE GADGET ONLY CLOSES THE WINDOW, but
  997.   doesn't quit the program. Additionally the following signals can be
  998.   sent to DeliTracker:
  999.  
  1000.         CTRL-C  Quit DeliTracker
  1001.         CTRL-D  Disable Commodity Broker
  1002.         CTRL-E  Enable Commodity Broker
  1003.         CTRL-F  DeIconify Windows
  1004.  
  1005.   6.8 ARexx
  1006.  
  1007.   Nearly all functions of DeliTracker can be controlled with ARexx.
  1008.   This is very nice if you are using other ARexx aware software like
  1009.   AmigaVision(TM). DeliTracker is addressed as a function host with
  1010.   the name "DELITRACKER". DeliTracker provides the following commands:
  1011.  
  1012.   quit                  Leave DeliTracker and shut down all genies/players.
  1013.  
  1014.   filter <yes|no>       yes: Switch filter on.
  1015.                         no:  Switch filter off.
  1016.  
  1017.   quick <yes|no>        yes: Turn quick on.
  1018.                         no:  Turn quick off.
  1019.  
  1020.   appicon <yes|no>      yes: Display appicon.
  1021.                         no:  No appicon.
  1022.  
  1023.   swapplay <yes|no>     yes: Turn low-memory handler on.
  1024.                         no:  Turn low-memory handler off.
  1025.  
  1026.   randmod <yes|no>      yes: Turn Randomplay on.
  1027.                         no:  Turn Randomplay off.
  1028.  
  1029.   songend <yes|no>      yes: Recognize songend signals.
  1030.                         no:  Ignore songend events.
  1031.  
  1032.   append <yes|no>       yes: Activate append mode.
  1033.                         no:  Deactivate append mode.
  1034.  
  1035.   activate <yes|no>     yes: activate windows at startup.
  1036.                         no:  all windows are opened inactive.
  1037.  
  1038.   timeout <SECS>        Set timeout to given number of seconds (SECS)
  1039.                         If SECS = 0 the timeout function is disabled.
  1040.  
  1041.   fadeout <SECS>        Set fadeout time in seconds. Zero deactivates
  1042.                         fadeing. Valid range is 0 to 5
  1043.  
  1044.   randsong <yes|no>     yes: start with randomly picked subsong.
  1045.                         no:  start with first subsong.
  1046.  
  1047.   playstart <yes|no>    yes: startmodule is played at startup.
  1048.                         no:  don't play a module at startup.
  1049.  
  1050.   volume <VOL>          Set volume to <VOL> (Range VOL: 0 to 64).
  1051.  
  1052.   balance <BAL>         Set balance to <BAL>, 0 is default, -64 left only,
  1053.                         64 right only (Range BAL: -64 to 64).
  1054.  
  1055.   forward               Play next pattern.
  1056.  
  1057.   backward              Play previous pattern.
  1058.  
  1059.   nextsong              Play next song (module).
  1060.  
  1061.   prevsong              Play previous song (module).
  1062.  
  1063.   nextsubsong           Play next subsong.
  1064.  
  1065.   prevsubsong           Play previous subsong.
  1066.  
  1067.   faster                Increase playspeed.
  1068.  
  1069.   slower                Decrease playspeed.
  1070.  
  1071.   loadconfig [FILE]     Load configfile [FILE] if [FILE] was specified,
  1072.                         else pop filerequester up.
  1073.  
  1074.   saveconfig [FILE]     Save configfile [FILE] if [FILE] was specified,
  1075.                         else pop filerequester up.
  1076.  
  1077.   savelist [FILE]       Save module list to [FILE] if [FILE] was specified,
  1078.                         else pop filerequester up.
  1079.  
  1080.   loadplayer [PLAYER]   Load the [PLAYER] if specified, else open
  1081.                         loadplayer requester.
  1082.  
  1083.   deleteplayer <NAME>   Remove player with name <NAME> from memory.
  1084.                         Note: all modules of this player won't be
  1085.                         recognized any longer.
  1086.  
  1087.   configplayer <NAME>   Call the configuration routine of the
  1088.                         player <NAME>.
  1089.  
  1090.   loadgenie [GENIE]     Load the [GENIE] if specified, else open
  1091.                         loadgenie requester.
  1092.  
  1093.   deletegenie <NAME>    Remove genie with name <NAME> from memory.
  1094.  
  1095.   configgenie <NAME>    Call the configuration routine of the
  1096.                         genie <NAME>.
  1097.  
  1098.   playpause             Play/Pause song.
  1099.  
  1100.   stop                  Stop song.
  1101.  
  1102.   playmod [MODULE]      play [MODULE] if [MODULE] was specified else pop
  1103.                         requester up.
  1104.  
  1105.   eject                 Remove active module from memory.
  1106.  
  1107.   makelist <MODULE>     Inserts [MODULE] at the current position into the
  1108.                         module list.
  1109.  
  1110.   clearlist [NUMBER]    Clear the modulelist entry [NUMBER] or clear the
  1111.                         whole list if [NUMBER] is ommited.
  1112.  
  1113.   playlist <NUMBER>     Play the module with the list position <NUMBER>.
  1114.  
  1115.   pubscreen <SCREEN>    Closes all DeliTracker windows and tries to reopen
  1116.                         all windows on the pubscreen <SCREEN>.
  1117.  
  1118.   showgui [NAME]        Opens the GUI of the specified player/genie or
  1119.                         all DeliTracker windows.
  1120.  
  1121.   hidegui [NAME]        Closes the GUI of the specified player/genie or
  1122.                         all DeliTracker windows.
  1123.  
  1124.   status <group> <dependent>  Returns the actual status. This funtion is
  1125.                         divided into four different groups: global
  1126.                         settings (g), player specific settings (p), module
  1127.                         dependent settings (m) and genie settings (j).
  1128.                         Additional arguments are specified after the group.
  1129.  
  1130.   <group> =     g :     Global
  1131.  
  1132.         <dependent>  = <cmd>
  1133.  
  1134.                <cmd>            description             returnvalue
  1135.  
  1136.                 pdr             playerdir               string
  1137.                 pub             prefered pubscreen      string
  1138.                 gdr             geniedir                string
  1139.                 lst             path of programfile     string
  1140.                 pnu             number of players       number
  1141.                 gnu             number of genies        number
  1142.                 vol             current volume          number
  1143.                 bal             current balance         number
  1144.                 tim             timeout in seconds      number
  1145.                 fad             fadeout                 number
  1146.                 ver             DeliTracker version     number
  1147.                 led             filter                  <yes|no>
  1148.                 qst             quickstart              <yes|no>
  1149.                 rmo             random module           <yes|no>
  1150.                 rso             random subsong          <yes|no>
  1151.                 app             append                  <yes|no>
  1152.                 swp             swap players            <yes|no>
  1153.                 act             activate window         <yes|no>
  1154.                 end             songend                 <yes|no>
  1155.                 ico             appicon                 <yes|no>
  1156.                 pst             play at start           <yes|no>
  1157.                 gui             windows open            <yes|no>
  1158.                 ply             paused or playing       <yes|no>
  1159.  
  1160.   <group> =     m :     Module
  1161.  
  1162.         <dependent>  =  <cmd>
  1163.  
  1164.                <cmd>            description             returnvalue
  1165.  
  1166.                 dir             moduledir               string
  1167.                 fil             filename                string
  1168.                 fmt             formatname              string
  1169.                 nam             real modulename         string
  1170.                 pna             name of current player  string
  1171.                 gna             name of used NP genie   string
  1172.                 max             selected modules        number
  1173.                 num             actual position in list number
  1174.  
  1175.   <group> =     p :     Player
  1176.  
  1177.         <dependent>  =  <playername> <cmd>
  1178.  
  1179.                <cmd>            description             returnvalue
  1180.  
  1181.                 nam             name                    string
  1182.                 cre             creator                 string
  1183.                 des             description             string
  1184.                 ver             player version          number
  1185.                 sho             show                    <yes|no>
  1186.                 hid             hide                    <yes|no>
  1187.                 ena             enabled                 <yes|no>
  1188.                 vol             volume                  <yes|no>
  1189.                 bal             balance                 <yes|no>
  1190.                 jmp             patternjump             <yes|no>
  1191.                 spd             playspeed               <yes|no>
  1192.                 sub             subsong                 <yes|no>
  1193.                 cfg             config                  <yes|no>
  1194.                 pck             packable                <yes|no>
  1195.                 int             internal interrupt      <yes|no>
  1196.                 npl             uses noteplayer         <yes|no>
  1197.                 end             songend detecton        <yes|no>
  1198.                 prc             running as process      <yes|no>
  1199.                 swp             swapable                <yes|no>
  1200.  
  1201.   <group> =     j :     Genie
  1202.  
  1203.         <dependent>  =  <geniename> <cmd>
  1204.  
  1205.                <cmd>            description             returnvalue
  1206.  
  1207.                 nam             genie name              string
  1208.                 cre             creator                 string
  1209.                 des             description             string
  1210.                 ver             version                 number
  1211.                 cfg             config                  <yes|no>
  1212.                 sho             show                    <yes|no>
  1213.                 hid             hide                    <yes|no>
  1214.                 ena             enabled                 <yes|no>
  1215.                 dcr             decrunch type           <yes|no>
  1216.                 cnv             convert type            <yes|no>
  1217.                 npl             noteplyer type          <yes|no>
  1218.                 prc             running as own process  <yes|no>
  1219.  
  1220.   Square brackets [...] mark arguments that may be omitted. Arguments in
  1221.   angle brackets <...> must be supplied.
  1222.  
  1223.   For almost any command example scripts are available. All commands
  1224.   may be entered in lower and upper case.
  1225.  
  1226.   Note: We changed the string handling, quotes are not needed any longer.
  1227.  
  1228.  
  1229. 7.NOTES
  1230.  
  1231.   The playspeed of a player is the same on PAL/NTSC machines as long as
  1232.   they don't generate their own interrupt (i.e use the inbuild interrupt
  1233.   generating mechanism).
  1234.  
  1235.   For Modem users: All players that use the DeliTracker internal timer
  1236.   Interrupt should now work well with serial transfers. Players which
  1237.   generate their own timer interrupt may probably not. This is due to
  1238.   the fact that instead of executing the actual playroutine in the timer
  1239.   interrupt itself, we cause a SoftInt (so that the real routine executes
  1240.   in a lower interrupt priority than the RFB interrupt).
  1241.  
  1242.  
  1243. 8.ACKNOWLEDGEMENTS
  1244.  
  1245. Our special thanks go to the following people:
  1246.  
  1247.   Our betatesters Stefan, Börnie and Manfred for their
  1248.   bugreports and ideas.
  1249.  
  1250.   Armin Sander (Oktalyzer) and Carsten Schlote (Sonic Arranger)
  1251.   for creating DeliPlayers for their soundsystems.
  1252.  
  1253.   Jörg W. Schmidt for the source code of PlayFTM.
  1254.  
  1255.   Tomas Partl for his player.
  1256.  
  1257.   Patrik Rak for creating the Spectrum-AY player.
  1258.  
  1259.   Markus Illenseer, Christian Rattei and especially K-H. Ruckmich
  1260.   for the correction and enhancement of the german docs.
  1261.  
  1262.   Acechan (and Logixs) for the french translation of the docs.
  1263.  
  1264.   U4ia and Christian von Roques for a quick scan of the english doc
  1265.   files in Version II.
  1266.  
  1267.   Kevin Dackiw for the enhancement of the NoisePacker players and
  1268.   the correction of the english doc files of V1.3x.
  1269.  
  1270.   DoIO for modules, demos and diskmag advertisement.
  1271.  
  1272.   Thomas Winischofer for MusicMaker
  1273.  
  1274.   Ekhall for sending some replay stuff.
  1275.  
  1276.   Markus "maw" Weichselbaum for the PT betas and the hints
  1277.   about the programming of the audio hardware.
  1278.  
  1279.   Stephan Schaem for the WindowFX sourcecode.
  1280.  
  1281.   Petter E. Stokke for the C-startupcode.
  1282.  
  1283.   Chris Marz for some modules.
  1284.  
  1285.   Dense for the X-Comm betas
  1286.  
  1287.   Olaf "Warp" Kalgraf for sending some programs
  1288.  
  1289.   Jamal Hannah for supplying us with many PC module format documentations.
  1290.  
  1291.   All on IRC #amiga & #amigager (Internet Relay Chat)
  1292.   Hi ALFred, Flintlund, laire, Janne, MASH, mnemo, stefanb, ZZA :-)
  1293.  
  1294.   Florian Vorberger for many nice modules, players and genies.
  1295.  
  1296.   Pink/Abyss for reporting odd behaviour of noteplayers.
  1297.  
  1298.   U. Dominik Müller for XPK.
  1299.  
  1300.   Eric Kennedy for TstApp.rexx.
  1301.  
  1302.   Nicolas Franck for Deli-Wizard.
  1303.  
  1304.   Chaos/Sanity and McDeal/Sanity for the 'DrWho' source.
  1305.  
  1306.   Jarno Paananen (Guru/Sahara Surfers) for the ScreamTracker3 and
  1307.   FastTrackerII player source.
  1308.  
  1309.   Bastian Spiegel (Twice/Lego) for the AON replay source.
  1310.  
  1311.   Jon Pickard for the NotePlayer adaption of the TFMX player.
  1312.  
  1313.   Kim Øyhus for his turbo-fast FFT routine.
  1314.  
  1315.   Andi da Silva for tons of new DeliPlayers.
  1316.  
  1317.   Mark "Marley" Leitiger for the Whittaker source.
  1318.  
  1319.   Christian Buchner for the CyberSound calibration-software.
  1320.  
  1321.   and all others, who have send replays, modules or registrations.
  1322.  
  1323.  
  1324.